Einheit 4 — Skills und der Fähigkeiten-Katalog

Was du nach dieser Einheit weißt: Du kannst einen Skill als eigenständigen Workflow-Abschnitt bauen, ihn über einen festen Vertrag an Router und Rückkanal anschließen und im Fähigkeiten-Katalog so beschreiben, dass die KI-Erkennung ihn zuverlässig findet.

Was ein Skill ist

Ein Skill ist eine abgeschlossene Fähigkeit des Assistenten: eine Wissensfrage beantworten, ein Ticket anlegen, eine Erinnerung setzen, eine Kennzahl nennen. Technisch ist ein Skill ein Workflow-Abschnitt mit

einem Eingang: ein Receiver Agent, der die Nachricht vom Router übernimmt,
beliebiger Logik dazwischen,
einem Ausgang: eine Nachricht an den Rückkanal.

Der Skill weiß nichts über Messenger, Berechtigungen oder Doppelverarbeitung — darum haben sich Eingang und Router schon gekümmert. Er konzentriert sich auf seine eine Aufgabe.

Der Vertrag zwischen Router, Skill und Rückkanal

Damit jeder Skill gleich angeschlossen werden kann, gelten feste Felder:

Was der Skill vom Router bekommt: das Einheitsformat aus Einheit 2, ergänzt um

Feld	Bedeutung
`vorgang_id`	ID des Vorgangs, zu dem die Antwort gehört
`faehigkeit`	Schlüssel des Skills
`frage`	ggf. die vom Router bereinigte Frage oder die Zusammenfassung der KI

Was der Skill an den Rückkanal schickt:

{
  "kanal": "nextcloud",
  "unterhaltung_id": "k7x2mqpa",
  "antwort_auf": "48211",
  "vorgang_id": "V-48211",
  "faehigkeit": "wissen",
  "antwort_text": "Urlaub beantragst du im Zeiterfassungssystem …",
  "vorgang_status": "beantwortet"
}

`vorgang_status`	Bedeutung
`beantwortet`	Auskunft gegeben, nichts mehr offen
`erledigt`	Aktion ausgeführt
`rueckfrage`	Der Skill braucht noch eine Angabe
`wartet_freigabe`	Eine Human Task wurde angelegt und wartet
`fehler`	Etwas ist schiefgegangen — die Antwort sagt ehrlich, was

Weil jeder Skill diesen Vertrag einhält, muss der Rückkanal nur einmal gebaut werden.

Der Fähigkeiten-Katalog

Welche Skills es gibt, steht nicht im Prompt, sondern in einer Tabelle:

CREATE TABLE assistent_faehigkeit (
  schluessel   TEXT PRIMARY KEY,   -- z. B. 'wissen'
  name         TEXT,               -- z. B. 'Frage ans Wiki'
  beschreibung TEXT,               -- was der Skill tut, in einem Satz
  beispiele    TEXT,               -- typische Formulierungen, mit ; getrennt
  risiko       INTEGER,            -- 0 bis 3, siehe unten
  ziel         TEXT,               -- Route, an die der Router verteilt
  rollen       TEXT,               -- wer den Skill nutzen darf, z. B. 'admin,vertrieb'
  aktiv        INTEGER,
  sortierung   INTEGER
);

Ein Eintrag sieht zum Beispiel so aus:

Feld	Wert
`schluessel`	`erinnerung`
`name`	Erinnerung
`beschreibung`	Erinnert dich im Chat zu einem bestimmten Zeitpunkt an etwas.
`beispiele`	erinnere mich Freitag um 9 an das Angebot; morgen früh an den Anruf denken; in 2 Stunden Bescheid geben
`risiko`	1
`ziel`	`erinnerung`

Das hat drei Vorteile:

Ein Skill ist an- und abschaltbar, ohne einen Workflow anzufassen: aktiv = 0.
Die Hilfe schreibt sich selbst. Auf „Hilfe“ baut der Router die Antwort aus Name, Beschreibung und erstem Beispiel jeder aktiven Zeile.
Die KI-Erkennung ist immer aktuell. Der Router liest den Katalog bei jeder Nachricht und setzt ihn in den Prompt ein.

Gute Beschreibungen schreiben

Die KI-Erkennung kennt die Skills nur über Beschreibung und Beispiele. Wie gut sie zuordnet, hängt direkt davon ab, wie gut diese Texte sind.

Schwach	Besser
„Kennzahlen“	„Beantwortet Fragen zu Umsatz, Zahlungseingang, offenen Posten und Stunden für einen Zeitraum, mit Vergleich zum Vorjahr.“
Beispiele: „Umsatz?“	Beispiele: „Wie hoch war der Umsatz im Oktober?; Was ist noch offen an Rechnungen?; Wie viele Stunden auf Projekt X diese Woche?“

Abgrenzen, wenn zwei Skills ähnlich klingen: „Firmenauskunft: alles zu einer Firma. Für Summen über alle Kunden → Kennzahlen.“
Echte Formulierungen als Beispiele nehmen, nicht ausgedachte. Die besten Beispiele kommen später aus der Lernschleife (Einheit 6).
Nicht zu viele Beispiele: drei bis fünf je Skill. Mehr verlängert den Prompt, ohne viel zu bringen.

Risikostufen

Jeder Skill bekommt eine Risikostufe. Sie entscheidet, wie vorsichtig der Router ist:

Stufe	Bedeutung	Beispiel	Verhalten
0	nur lesen	Wissensfrage, Kennzahl	sofort ausführen
1	intern anlegen, leicht rückgängig zu machen	Erinnerung, Ticket	sofort ausführen
2	wirkt nach außen oder ändert Daten	Mail an Kunden, Status im CRM ändern	Bestätigung im Chat
3	schwer rückgängig zu machen	Zahlung freigeben, Daten löschen	Human Task mit vollständiger Vorschau

Die Risikostufe legt der Mensch fest, nicht die KI. Auch eine KI-Erkennung mit Sicherheit 0,99 ändert nichts daran, dass ein Skill der Stufe 2 bestätigt werden muss.

Vier Arten von Skills

Auskunfts-Skills lesen Daten und formulieren eine Antwort. Beispiel: Wissensfrage, Kennzahl, Firmenauskunft.

Aktions-Skills ändern etwas: Ticket anlegen, Erinnerung speichern, Angebot erstellen. Sie melden das Ergebnis mit einem Link oder einer Nummer zurück, damit die Person es prüfen kann.

Dialog-Skills brauchen mehrere Angaben und fragen fehlende nach. Beispiel: Für ein Angebot fehlt die Menge → Rückfrage im Chat. Der Skill speichert seinen Zwischenstand in einer eigenen Tabelle; der Router erkennt an einem offenen Eintrag dort, dass die nächste Nachricht die Antwort auf die Rückfrage ist.

Proaktive Skills werden nicht durch eine Nachricht ausgelöst, sondern durch die Zeit oder ein Ereignis: das Morgenbriefing um 7:30, eine fällige Erinnerung, eine Warnung, dass ein Datenimport ausgefallen ist. Sie schicken ihre Nachricht ebenfalls an den Rückkanal — mit einer festen unterhaltung_id und leerem antwort_auf.

Fang mit Auskunft an

Ein neuer Assistent sollte mit Auskunfts-Skills starten. Sie sind risikolos, liefern sofort Nutzen und erzeugen das, was der Assistent zum Lernen braucht: echte Fragen in echten Formulierungen.

Kurzer Selbst-Check

Ein Skill „Angebot erstellen“ legt nur einen Entwurf an, der vor dem Versand ohnehin per Human Task freigegeben wird. Welche Risikostufe?

Stufe 1. Der Skill selbst wirkt nicht nach außen — der Entwurf ist intern und kann verworfen werden. Die Freigabe des Versands ist ein eigener Schritt mit eigener Absicherung.

Die KI ordnet „Was ist bei Müller los?“ regelmäßig dem Skill Kennzahlen zu statt der Firmenauskunft. Was tust du zuerst?

Die Beschreibungen schärfen und abgrenzen, etwa „Firmenauskunft: alles zu einer bestimmten Firma — Deals, Rechnungen, letzte Kontakte“. Zusätzlich hilft ein Beispiel wie „Was ist bei Firma X los?“. Hält das Problem an, korrigiert die Lernschleife aus Einheit 6 den Einzelfall.

Was ein Skill ist​

Der Vertrag zwischen Router, Skill und Rückkanal​

Der Fähigkeiten-Katalog​

Gute Beschreibungen schreiben​

Risikostufen​

Vier Arten von Skills​

Kurzer Selbst-Check​